package com.shopping_back.service;

import java.util.List;
import java.util.Map;

/**
 * 仪表盘数据服务接口
 */
public interface IDashboardService {
    /**
     * 查询订单状态分布
     * @return List of { status: int, count: long }
     */
    List<Map<String, Object>> getOrderStatusDistribution();

    /**
     * 查询商品销量排行榜 (Top N)
     * @param topN 前 N 名
     * @return List of { skuName: String, sales: long }
     */
    List<Map<String, Object>> getTopSellingSkus(int topN);

    /**
     * 查询促销活动参与度对比
     * @return List of { activityName: String, quantity: long }
     */
    List<Map<String, Object>> getPromotionParticipation();

    /**
     * 查询评价星级分布
     * @return List of { score: int, count: long }
     */
    List<Map<String, Object>> getEvaluationRatingDistribution();
}
